---
title: Checkbox
description: A control that allows the user to toggle between checked and not checked.
component: true
links:
  doc: https://www.radix-ui.com/docs/primitives/components/checkbox
  api: https://www.radix-ui.com/docs/primitives/components/checkbox#api-reference
---

<ComponentPreview 
name="checkbox-demo" 
description="A checkbox"
button="copy"
dots={false}
styleSwitch
 />

## Installation

<Tabs defaultValue="cli">

<TabsList>
  <TabsTrigger value="cli">CLI</TabsTrigger>
  <TabsTrigger value="manual">Manual</TabsTrigger>
</TabsList>
<TabsContent value="cli">

```bash
npx nyxb@latest add checkbox
```

</TabsContent>

<TabsContent value="manual">

<Steps>

<Step>Install the following dependencies:</Step>

```bash
 @radix-ui/react-checkbox
```

<Step>Copy and paste the following code into your project.</Step>

<ComponentSource name="checkbox" />

<Step>Update the import paths to match your project setup.</Step>

</Steps>

</TabsContent>

</Tabs>

## Usage

```tsx
import { Checkbox } from "~/components/ui/checkbox"
```

```tsx
<Checkbox />
```

## Examples

### With text

<ComponentPreview
  name="checkbox-with-text"
  description="A checkbox with label and description."
  button="copy"
  dots={false}
  styleSwitch
/>

### Disabled

<ComponentPreview 
   name="checkbox-disabled" 
   description="A disabled checkbox"
   button="copy"
   dots={false}
   styleSwitch
 />

### Form

<ComponentPreview 
   name="checkbox-form-single"
   button="copy"
   dots={false}
   styleSwitch
 />

<ComponentPreview 
   name="checkbox-form-multiple"
   button="copy"
   dots={false}
   styleSwitch
 />
